Skip to content

Conversation

@Rodriguespn
Copy link
Collaborator

@Rodriguespn Rodriguespn commented Jan 26, 2026

What kind of change does this PR introduce?

Introduces the foundational structure for the supabase agent skill - a comprehensive guide for AI agents working with Supabase products.

What is the current behavior?

There is no skill available to guide AI agents on how to properly use Supabase products.

What is the new behavior?

This PR adds the supabase skill scaffolding that will serve as a comprehensive guide covering Supabase core products: Auth, Database, Storage, Edge Functions, Realtime, CLI, supabase-js SDK, and MCP server.

Files Added

File Description
SKILL.md Agent-facing skill manifest following the Agent Skills Open Standard. Contains the skill metadata, description, and resource index pointing to all available references.
AGENTS.md Auto-generated compiled document containing all references. Do not edit directly - regenerated by npm run build.
GETTING_STARTED.md Step-by-step contribution guide for product teams to add their content.
references/_template.md Template file for creating new reference documents. Copy this when adding new content.

These files files were revised by Opus 4.5 with the Anthropic skill-creator skill

How to Contribute

To add content for your product, follow the instructions in GETTING_STARTED.md.

Quick summary:

  1. Create a branch from feature/supabase-skill
  2. Copy references/_template.md to references/{your-product}.md
  3. Add your content following the template structure
  4. Update the resource table in SKILL.md
  5. Run npm run validate && npm run build && npm run check
  6. Open a PR targeting feature/supabase-skill

@Rodriguespn Rodriguespn self-assigned this Jan 26, 2026
@Rodriguespn Rodriguespn added the new-skill Adding a new skill label Jan 26, 2026
@Rodriguespn Rodriguespn force-pushed the feature/supabase-skill branch 3 times, most recently from c9a10b7 to 6356065 Compare January 26, 2026 21:01
@Rodriguespn Rodriguespn marked this pull request as ready for review January 26, 2026 21:11
@Rodriguespn Rodriguespn force-pushed the feature/supabase-skill branch 2 times, most recently from 9cab06c to 803e968 Compare January 27, 2026 18:44
Rodriguespn and others added 15 commits January 28, 2026 15:53
The CLAUDE.md symlink causes installation errors when using
`npx skills add` as it tries to copy AGENTS.md to itself.

- Remove createClaudeSymlink function from build.ts
- Remove claudeSymlink from SkillPaths interface
- Remove CLAUDE.md references from AGENTS.md structure documentation
- Delete existing CLAUDE.md symlink from skills directory

Co-Authored-By: Claude Opus 4.5 <[email protected]>
* feat: supabase db references

* refactor: move database references to db subdirectory

Move all database reference files to references/db/ to organize
by product area and take advantage of the new subdirectory support
in the build system.

Co-Authored-By: Claude Opus 4.5 <[email protected]>

---------

Co-authored-by: Claude Opus 4.5 <[email protected]>
The build system now correctly preserves subdirectory paths when
generating the Available References section. For example, files in
references/db/ are now listed as references/db/file.md instead of
just references/file.md.

Co-Authored-By: Claude Opus 4.5 <[email protected]>
@Rodriguespn Rodriguespn force-pushed the feature/supabase-skill branch from 4cdb582 to 7a861d9 Compare January 28, 2026 15:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

new-skill Adding a new skill

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants